home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / asmcode.lbr / FD.DQC / FD.DOC
Encoding:
Text File  |  1985-06-03  |  4.4 KB  |  100 lines
  1.  
  2. FILE-DIRECTOR
  3.  
  4. Version 2.00 For IBM-PC and compatables.  Requires DOS 2.0 or later.
  5.  
  6.  This program is a memory resident module that intercepts all file open calls to
  7. DOS, and attempts to open the file using the current directory on the default
  8. drive, then using the drives, directories, and subdirectories specified in the
  9. File-Director (FD) command.
  10.  
  11. COMMAND FORMAT
  12.  
  13.   FD [[d:]path[[;[d:]path]...]]
  14.  
  15.  You may specify a list of drives and path names, seperated by semicolons (note
  16. that the path names must be specified and will not default to the current
  17. directory).  Then when you attempt to open a file that is not found in the
  18. current directory that was implied, File-Director searches the named directories
  19. in the order you entered them.  The current directory is not changed.
  20.  
  21.  If the optional parameters are omitted, the current path(s) are displayed.  If
  22. a single semicolon is entered as the paramater, the search path is set to null
  23. (as if File-Director did not exist), and only the current directory is searched
  24. for the file.
  25.  
  26.  Note that this format is identical to that used by the DOS 'PATH' command.
  27.  
  28. EXAMPLE:
  29.  
  30.    FD C:\;C:\DATA;A:\
  31.  
  32.  This tells File-Director to search for your file in the current directory, then
  33. in the root directory on drive C, then the DATA subdirectory on drive C, then
  34. finally on drive A.
  35.  
  36.  INSTALLATION:
  37.  
  38.  Simply copy FD.COM to your DOS backup diskette, or your hard disk.  If you want
  39. to use a specific path most of the time, you can put the FD command in your
  40. AUTOEXEC.BAT file.  File-Director is not copy protected, so you may put it on
  41. each DOS diskette you have.
  42.  
  43. NOTES:
  44.  
  45. 1) File-Director will not detect invalid paths.  They will be detected at file
  46.    open time and will not be searched. No error messages are generated by
  47.    File-Director.
  48.  
  49. 2) File-Director will only search for files where the drive and path are
  50.    implicit.  (i.e.  if you specify a file as "c:\data\names.dat" File-Director
  51.    will not be able to look for it anywhere but in C:\DATA.  For the program to
  52.    find this file, it should be specified simply as "NAMES.DAT", and the
  53.    "C:\DATA" should be in File-Director's search path.
  54.  
  55. LIMITATIONS:
  56.  
  57.  A file newly created by your program will usually end up in the current
  58. directory.  File-Director cannot know where the file should be put.  If you are
  59. reading your input from the directory "C:\DATA", the output file should be
  60. specified as "C:\DATA\filename.ext" if you want the output file in the same
  61. directory as the input file.  If the specific path is omitted on a file create,
  62. the file will be created in the current directory.
  63.  
  64.  For full support under File-Director the file to be searched for must be opened
  65. using the file handle format in DOS 2.X.  The older applications that used File
  66. Control Blocks cannot completly use a file path.  Fortunatly, most of the newer
  67. programs (including BASIC interpreter) use the File Handles, and support paths.
  68. BASIC also searches along File-Director's paths for programs when you do a
  69. "LOAD" command.
  70.  
  71.  File-Director will support File Control Blocks, but there are some differences.
  72. If a file is only read and not written to, it is completely supported. If a
  73. file is opened as a random access file (like BASIC compiler does) File-Director
  74. supports that access mode also. However, if a file is opened for APPEND, and
  75. it is not in the current directory, the file will be found along the filepath,
  76. opened, but the updates will be written to the default drive in the current
  77. directory. This is unfortunate, but unavoidable due to the structure of DOS.
  78. If you open files for APPEND, be sure that they are in the current directory
  79. or the drive is explicitly specified.
  80.  
  81.  The best advice is to try every program you intend to use File-Director with
  82. if the program uses FCB's, or you are not sure. Use a back up copy of your data
  83. for this test.
  84.  
  85. Comments:
  86.  
  87.  Use caution when reading and writing files with File-Director.  It will always
  88. find and open the FIRST file along its paths that matches the input filename.
  89. It will not detect DUPLICATE file names.  There should never be duplications of
  90. file names along File-Director's paths, as the second file will never be found
  91. unless its path is explicitly specified when it is opened.
  92.  
  93.  
  94. If you have comments, or I can answer a question for you, please write.
  95.  
  96.     Bob Murphy
  97.     PO BOX 23260
  98.     Richfield, MN 55423
  99.  
  100.